---
title: "Incident.io Provider"
sidebarTitle: "Incident.io Provider"
description: "The Incident.io provider enables the querying of incidents on Incident.io, leveraging incident management capabilities for effective response."
---

## Overview

The Incident.io provider facilitates interaction with Incident.io's API, allowing for the management of incidents. This includes the ability to query specific incidents, retrieve all incidents, and manage incident details. This provider integrates Keep's system with Incident.io's robust incident management platform.


### Query Specific Incident

- `incident_id`: The ID of the incident to be queried. Required for fetching specific incident details.

## Outputs

Returns the specific incident with id=`incident_id`

## Authentication Parameters

- `incidentIoApiKey`: API key for authenticating with Incident.io's API.

## Scopes

- `authenticated`: Mandatory for all operations, ensures the user is authenticated.
- `read_access`: Mandatory for querying incidents, ensures the user has read access.

## Connecting with the Provider

### API Key

To use the Incident.io API:
1. Log in to your Incident.io account.
2. Navigate to the "API Keys" section under your account settings.
3. Generate a new API key or use an existing one.
4. Ensure it has `read` permissions enabled for reading and managing incidents.

### Incident Endpoint

The Incident.io incident endpoint allows querying and managing incidents. Operations include retrieving specific incident details or fetching a list of all incidents. This is crucial for monitoring and responding to incidents efficiently.

For more details, refer to the [Incident.io API Documentation](https://api-docs.incident.io/).

## Notes

This provider is part of Keep's integration with Incident.io, designed to enhance operational resilience by enabling efficient incident management and response.

## Useful Links

- [Incident.io API Documentation](https://api-docs.incident.io/)
- [Incident.io Incidents](https://api-docs.incident.io/tag/Incidents-V2)
- [Incident.io Api_Keys and Permissions](https://help.incident.io/en/articles/6149651-our-api)
